Pull Request Checklist

• I have read and followed the CONTRIBUTING.md guidelines.
• My contribution adds a new instruction, prompt, agent, skill, or workflow file in the correct directory.
• The file follows the required naming convention.
• The content is clearly structured and follows the example format.
• I have tested my instructions, prompt, agent, skill, or workflow with GitHub Copilot.
• I have run npm start and verified that README.md is up to date.

Goal

The existing azure-devops-cli/skill/SKILL.md is too large. By separating it to smaller files, the agents can efferently load a partial of the skill, which not only saves tokens, but also helps AI to focus.

Structure

The original monolithic SKILL.md (2,466 lines) has been split into a compact main file with on-demand reference files to save tokens.

skills/azure-devops-cli/
├── SKILL.md                              (93 lines - basics + routing table)
└── references/
    ├── repos-and-prs.md                  (Repositories, PRs, Git refs, branch policies)
    ├── pipelines-and-builds.md           (Pipelines, runs, builds, releases, artifacts)
    ├── boards-and-iterations.md          (Work items, area paths, iterations)
    ├── variables-and-agents.md           (Pipeline variables, variable groups, agents)
    ├── org-and-security.md               (Projects, teams, users, permissions, wikis, admin)
    ├── advanced-usage.md                 (Output formats, JMESPath queries, global args)
    └── workflows-and-patterns.md         (Workflows, best practices, scripting patterns)

Only SKILL.md is loaded when the skill triggers. Reference files are read on demand based on the user's task.

Token Estimation

Estimated using ~1 token per 4 characters (English text approximation).

Most tasks only need 1-2 reference files, saving 60-90% tokens compared to loading everything upfront.

Type of Contribution

• New instruction file.
• New prompt file.
• New agent file.
• New plugin.
• New skill file.
• New agentic workflow.
• Update to existing instruction, prompt, agent, plugin, skill, or workflow.
• Other (please specify):

Additional Notes

By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.